home *** CD-ROM | disk | FTP | other *** search
/ Programming Sound Cards / Programming Sound Cards.iso / sound_68 / detect.doc < prev    next >
Text File  |  1995-01-01  |  3KB  |  83 lines
  1.                 C-Module for Sound Card Detection
  2.  
  3.      Function documentation of Creative Sound Library Module
  4.  
  5. 1. Introduction
  6.  
  7.     Author          :  T S Lee
  8.     Version         :  1.00
  9.     Last Updated    :  22 Sep 1989
  10.  
  11.     This version uses a more reliable detection scheme. Please
  12.     replace all older verions with it.
  13.  
  14.  
  15.     The  library  functions provided is for Microsoft  C  version
  16.     5.00 and above. All the memory models, SMALL, COMPACT, MEDIUM
  17.     and  LARGE  are  available. These functions  are  grouped  in
  18.     library files named in following conversion:
  19.  
  20.           DETECTx.LIB
  21.  
  22.     where  "x"  is the first character of the  respective  memory
  23.     model.
  24.  
  25.     The default segment and group name defined in Microsoft C for
  26.     each memory model is used to ensure compatibility. Any global
  27.     variable  memtioned in following section must be declared  in
  28.     the default data segment '_DATA'.
  29.  
  30.  
  31.     The  FM feature of the Sound Blaster Card may be an  optional
  32.     item in some OEM versions. So we suggest that if you want  to
  33.     play  FM  music on the Sound Blaster Card, separate  FM  chip
  34.     detection is required.
  35.  
  36.  
  37.     The Sound Blaster Card is compatible with the C/MS card (Game
  38.     Blaster), but it uses a different card detection scheme. Hence,
  39.     to maintain upward compatibility in your software, we strongly
  40.     suggest that you call this library routine for card detection.
  41.  
  42.  
  43.  
  44. 2. Function Documentation
  45.  
  46. Function    :  unint _ct_card_here()
  47.  
  48. Description :  Check   for  the  availibity  of   the   various
  49.                music/sound  features  provided by  Creative.
  50.  
  51.                The  check is based on the I/O address  stored  in
  52.                the global variable ct_io_addx which is defined in
  53.                the application program.
  54.  
  55. Entry       :  none
  56. Return      :  Music/Sound feature available
  57.  
  58.                High byte is alway zero now
  59.                Low byte right most 3 bits indicate as follow
  60.  
  61.                     bit 0 : on for C/MS music available
  62.                     bit 1 : on for FM music available
  63.                     bit 2 : on for Creative voice (DSP) available
  64.  
  65.                The type of Creative Music/Sound Card available on
  66.                the  system  can  be determined  with  the  return
  67.                value.
  68.  
  69.                Game  Blaster Card returns 1.
  70.                Sound Blaster Card without FM music  returns 5 ,
  71.                                   with the FM music, returns 7.
  72.  
  73.  
  74. Note        -  The I/O address used for the music/sound card must
  75.                be   stored   in  ct_io_addx  before   the   call.
  76.                (Application can set this variable to the  factory
  77.                defualt value, 220 Hex). There are 6 sets of I/O
  78.                addresses : 210H, 220H, 230H, 240H, 250H and 260H.
  79.  
  80.             -  A  zero return value may due to wrong I/O  address
  81.                used.
  82.  
  83.